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METHOD OF REDIRECTING CLIENT REQUESTS TO WEB SERVICES 

Technical field 

The invention relates to the web services provided to the 
clients of the Internet network and in particular relates to a 
5 method of redirecting the client requests to the web service 
when its address has changed. 

Background 

It is a common knowledge that it is possible to have access to 
more and more services on the Internet network. So the 
10 Internet users are interested in obtaining information about 
on-line services on the Internet and how to request these 
services. The on-line services are generally provided by 
application service providers, but the re are also services 
which are domain-oriented like the request on life sciences. 

15 Today, it is possible for a client to obtain a requested 
information by using the ^^Web Services"' which is a specific 
business functionality exposed by a company, usually through 
an Internet connection, for the purpose of providing a way for 
a client, a company or a program to use the service. Web 

20 services are becoming a backbone for the electronic commerce 
and the exchange with the application service providers. 

A service provider providing public web services on the 
Internet network has to describe the whole informations 
regarding the web service. To do that, he can provide a Web 
25 Service Definition Language (WSDL) file associated with the 
web service. A WSDL is useful to describe the interface 
(methods, parameters,...) and the runtime (bindings, 
addresses,-..) of the service. From the client point of view, 
a WSDL file contains all the info3:mation required to build the 
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client structure- Normally^ a client would use the WSDL file 

only at the build time and not at the run time. 



In a normal production models it is sure that a WSDL will 
evolve because of new functional or runtime requirements- The 
5 main difficulty when a service provider wants to update a web 
service and the associated WSDL file is the notification of 
all the web service clients. In fact;, in case of a public web 
service,, the service provider does not know the web service 
clients, and therefore he cannot notify them of a change. 

10 Some practices regarding changes in the interface of a web 
service are provided. Thus, a change in the interface should 
be always compatible with previous versions- For instance, new 
methods are allowed in a WSDL file, but the removal of these 
methods is forbidden. 



15 However, there is no way for a service provider to notify all 
web service clients when the end point address of one of its 
public web service changes . The reasons are that he does not 
use a reverse proxy or a web service gateway and wants to move 
the web service from a first host to another more powerful 

* 

20 host, or he wants to add a load-balancing solution in front of 
the web service, or he wants to add a web service gateway, a 
secure proxy in front of it, or he has to change the domain 
name . 



An existing solution already exists for the HTTP protocol as 
25 transport protocol using 3xx HTTP status codes. A client 
browser receiving a 3xx HTTP response code knows that the 
location of the required document has changed and the browser 
automatically generates a new HTTP request to the location 
indicated in the 3xx HTTP response code. But this solution 
30 cannot be applied for web services using Single Object Access 
Protocol (SOAP) as message exchange protocol for two reasons. 
Firstly, the codes 3xx are not automatically handled by 
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runtimes that provide the binding between SOAP and HTTP. 
Secondly^ the communication protocol for the SOAP messages is 
not only HTTP since the SOAP messages can also be sent on 
other transport protocols like SMTP^ JMS, . . . and the 3xx HTTP 
5 status codes for redirection are not available on these 
protocols - 

Summary of lihe lnven1:lon 

Accordingiy^ the object of the invention is to achieve a 
method of redirecting a client of a web service to a new end 
10 point addrress in case of a runtime change. 

The invention therefore relates to a method of redirecting a 
request for a web service in a data transmission network such 
a the Internet wherein^ in response to a request forwarded by 
a host of a client to a web service provider, this one 

15 provides a. Web Service Definition Language (WSDL) file based 
upon a message exchange protocol such as Simple Object Access 
Protocol (SOAP) on a transport protocol such as HTTP. This 
method comprises the steps of forwarding a first request from 
the client to an old address of the web service, responding to 

20 the client from the web service point associated with the old 
address by sending back a message wherein the header using 
the message exchange protocol contains the new address 
redirection of the requested web service, and forwarding a 
second req[uest from the client to the new address of the web 

25 service - 

According to another aspect^ the invention relates to a system 
comprising- a checker in the SOAP runtime of the service 
provider being adapted to check whether a request forwarded 
from the SOAP runtime of a client to the service provider has 
30 to be redirected to a new point address and to provide the new 
point addrress to which the request must be forwarded, this new 
point add.ress being provided in a SOAP response message 
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forwarded from the service provider at the old point address 
to the SOAP runtime of the client, and a checker in the SOAP 
runtime of the client adapted to check whether the SOAP 
response message contains the new point address and regenerate 
5 the same request and to forward it to the new point address. 

Brief descrip-tlon of the drawings 

The above and other objects, features and advantages of the 
invention will be better understood by reading the following 
more particular description of the invention in conjunction 
10 with the accompanying drawings wherein: 

■Fig. 1 is a schematic diagram representing the method 
according to the invention; 

■Fig, 2 is a block-diagram representing the system according 
to the invention; 
15 "Fig. 3 is a flow chart representing the steps of the method 
which is implemented in the SOAP runtime associated with the 
old web service address; and 

■Fig. 4 is a flow chart representing the steps of the method 
which is implemented in the SOAP runtime of the client. 

20 Det:alled descrlpiilon of the Invention 

In reference to FIG.l^. it is assumed that a web service client 
10 based upon the message exchange protocol SOAP wants to have 
access to web services provided by a service provider- In such 
a case,- a first request is forwarded from the host 10 to the 

25 current web service address which is the old address point 12 
since the user does not know that the address of the web 
service has been changed- The old point address 12 answers 
back to the host 10 by providing the redirection in the header 
of the response message as described later. Using the 

30 redirect ion contained in the SOAP message received from the 
old point address^ the host 10 can then transmit a second 
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request to the new web service address 14 in order to get a 
response to this request- Note that the host can be prograrnmed 
to log the redirection in order to make further SOAP requests 
directly to the new point address - 

5 An implementation of the method according to the invention is 
illustrated in FIG. 2. The web service client station 10 
includes normally two functionalities : a client application 
18 and a SOAP runtime contains a checker 22 which is a 
component in charge of checking whether a received SOAP 

10 message contains a redirection in its header. If so^ the 
checker regenerates the same SOAP request to the new point 
address provided in the header as mentioned above and 
optionally logs the redirection to allow code changes in the 
client application in order to direct the future requests to 

15 the right address. Note that the checker 22 is generally a 
routine within the runtime, but could be an independent 
component accessed by the client runtime each time it receives 
a SOAP message - 

The web service provider 2 4 includes a first HTTP 26 server as 
20 usual and a SOAP runtime like the client one. The runtime is 
adapted to gain access to the web service such as web services 
WS 1^ WS 2 andL WS 3 - As for the client^ the SOAP runtime 28 of 
the service provider has at its disposal a checker 30 which 
can be a software part within the runtime or an independent 
25 component accessed when a SOAP request is received. Note that 
any other transport protocol than HTTP could be used such as 
SMTP. In the latter case, the server 26 would be a SMTP 
server . 

Each time a SOAP request is received from a client 10, the 
30 checker 30 is adapted to check whether the address of the 
requested web service is the right address or an old address 
because the web service has moved to another machine or 
address and has become outdated. For this, the checker 30 has 
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access to a component 32 knowing which are the web services 
that have been outdated and the new address if the requested 
service is outdated. Then^ the checker is adapted to provide 
the new address to the runtime in order to have it included in 
5 the header: of the SOAP message returned to the client. 

The way to include the new address in the header of the SOAP 
message is to create a SOAP header tag that has the name 
^^Redirecf and is included in the SOAP specification to ensure 
that all SOAP runtimes used by the clients and service 
10 providers will understand it. Nevertheless^ the inclusion of 
the header in the SOAP specification is not mandatory. It 
could be a SOAP extension supported only by several runtimes 
which would provide a higher quality of service clients and 
service providers using these runtimes . 

15 An example of such a header in a SOAP response message could 
be the following XML code: 

<soapenv : Header> 

<soapenv : Redirect soapenv :mustUnderstand="l''> 
Http: //newhost . domain. com/services/PublicWebService</soapenv: 
20 Redirect> 

</soapenv: Header> 

The behavior of the server SOAP runtime server which provides 
the web services is illustrated in FIG. 3. At the beginning, 
the SOAP runtime waits for a SOAP request (step 40) . As 

25 already mentioned, the SOAP runtime has access to properties 
file, generally written in XML, that provides the list of the 
outdated web services. A new point address is associated with 
each of said outdated web services. Therefore, after getting a 
SOAP request, the checker retrieves the outdated web service 

30 in this list (step 42) and checks whether the web service 
requested by the client is a outdated web service (step 44) . 
If the web service is present in this list of outdated web 
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services^ the SOAP runtime does not try to contact the web 
service but sends back a SOAP response with the SOAP 
redirection header (step 4 6) . As already explained^ this 
header contains the new point address provided by the 
5 properties file. The SOAP body is filled with the exact SOAP 
body received from the client in order to allow the client 
SOAP runtime running again the same SOAP request to the new 
point address. 



If the web service is not present in the list of outdated web 
10 services, the SOAP runtime continues its normal work^ that is 
forwarding the SOAP request to the appropriate web service 
(step 48) . In any case, the process is looped back to the 
starting step of waiting for a SOAP request (step 40) . 

The behavior of the client SOAP runtime is illustrated in 
15 FIG. 4, At the beginning, the runtime waits for a SOAP response 
(step 50) . Then the checker of the runtime checks whether this 
response contains a redirection header (step 52) . If so, the 
SOAP runtime regenerates a new SOAP request to the new point 
address contained in the message header (step 54) . The SOAP 
20 runtime also gets the SOAP body from the SOAP response and 
puts it in the new SOAP request- Optionally, the SOAP runtime 
can also log the redirection to allow further changes in the 
client code and therefore direct access to the new address 
without the need of requesting the redirection (step 56) . If 
25 there is no redirection header in the SOAP response message, 
the SOAP runtime continues its normal work, that is forwarding 
the SOAP response to the client (step 58) . In any case, the 
process is looped back to the starting step of waiting for a 
SOAP response (step 50) . 

30 Even though the Single Object Access Protocol (SOAP) is used 
in the preferred embodiment of the invention, it must be noted 
that any other message exchange protocol than SOAP could be 
used whatever the transport protocol being used- 
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1. Method of redirecting a request for a web service in a data 
transmission network such a the Internet wherein^ in 
response to a request forwarded by a host (10) of a client 
to a web serv^ice provider (24) , this one provides a Web 
Service Definition Language (WSDL) file based upon a message 
exchange protocol such as Simple Object Access Protocol 
(SOAP) on a tra.nsport protocol such as HTTP; 

said method being characterized in that it comprises the 
steps of: 

forwarding sl first request from the client to an old 
address of said web service 12)^ 

responding to the client from the web service point 
associated with, said old address by sending back a message 
wherein the header using said message exchange protocol 
contains the now address redirection of the requested web 
service (14)^ and 

forwarding a. second request from the client to the new 
address of saidL web service . 

2 . Method according to claim 1, wherein said new address 
(redirection) of the requested web service (14) is logged by 
said host (lO) to allow code changes in the client 
application in order to direct the future requests to the 
right address • 

3- Method according to claim 2^ wherein said message exchange 
protocol is SOAP and said redirection is a SOAP header tag 
^^Redirect" included in the SOAP specification to ensure that 
all SOAP runtimes used by the clients and service providers 
will understand, it. 

4. System for redirecting a request for a web service in a data 
transmission network such as the Internet wherein a response 
to a request forwarded by a host (10) of a client to a web 
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service provider (24) , this one provides a Web Service 
Definition Language (WSDL) file based upon the Simple Object 
Access Protocol (SOAP) on a transport protocol such as HTTP; 
said system being characterized in that it comprises 
a checker (30) in the SOAP runtime of said service 
provider (24) being adapted to check whether a request 
forwarded from the SOAP runtime of a client to said service 
provider h.as to be redirected to a new point address and to 
provide the new point address to which the request must be 
forwarded, said new point address being provided in a SOAP 
response message forwarded from said service provider at the 
old point address to said SOAP runtime of the client^ and 

a checker in said SOAP runtime of the client adapted to 
check whether said SOAP response message contains the new 
point address and regenerate the same request and to forward 
it to said, new point address (14) . 

System according to claim 4, further comprising a list of 
the outdated web services (32) to which said checker (30) in 
the SOAP runtime (2 8) of the service provider has access to 
check whether said request has to be redirected to a new 
point address. 

System according to claim 4 or 5,^ wherein said new point 
address is provided in the header of said SOAP response 
message . 
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